home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 14 / 7 / DISK1471.ZIP / PTDOC.DOC < prev    next >
Text File  |  1989-05-12  |  40KB  |  991 lines

  1.  
  2.  
  3.  
  4.  
  5.              POP TRAIN Copyright (c) 1988, 1989 JOHN M. MAJKRZAK. 
  6.                              All Rights Reserved 
  7.  
  8.  
  9.  
  10.                      A Trainable RAM Resident Help System.
  11.  
  12.  
  13.                              - TABLE OF CONTENTS -
  14.  
  15.  
  16.          INTRODUCTION .............................................  1
  17.          OVERVIEW .................................................  1
  18.          DISCLAIMER OF WARRANTY ...................................  2
  19.          REGISTRATION INFORMATION .................................  2
  20.          SYSTEM REQUIREMENTS ......................................  3
  21.          GETTING ACQUAINTED .......................................  3
  22.            LOADING POP TRAIN ......................................  4
  23.            CALLING POP TRAIN TO ACTION ............................  4
  24.            USING POP TRAIN WITH TRAINEES ..........................  4
  25.            SAVING YOUR SCHEMA FILE ................................  4
  26.            REMOVING POP TRAIN FROM MEMORY .........................  4
  27.          PLANNING A HELP SYSTEM ...................................  5
  28.            SCHEMA NAME CONSIDERATIONS .............................  5
  29.            PAGE RECOGNITION CONSIDERATIONS ........................  5
  30.            FIELD/CURSOR CONSIDERATIONS ............................  5
  31.            MAKE A PLANNING SHEET ..................................  6
  32.          UTILITIES ................................................  6
  33.            RAM ....................................................  6
  34.            PAGE ...................................................  6
  35.            EDIT ...................................................  6
  36.            MODIFY .................................................  7
  37.          MULTIPLE APPLICATIONS ....................................  7
  38.          RAM DRIVE USAGE ..........................................  7
  39.          DIRECTORIES/FILES AND POP TRAIN ..........................  8
  40.          FLOPPY DISK ONLY USERS ...................................  8
  41.          CONFIGURATION OF POP TRAIN ...............................  9
  42.            AUTOMATIC POP-UP .......................................  9
  43.            AUTOMATIC REMOVAL OF PRESENTATION SCREEN ............... 10
  44.            KEYBOARD RETURNS; K/0, K/1, K/2 ........................ 10
  45.            DIGITAL VOICE PLAYBACK ................................. 11
  46.            HOT/HELP KEYS .......................................... 11
  47.          REVISION HISTORY AND NOTES ............................... 12
  48.          PROBLEM REPORTING ........................................ 12
  49.          CREDITS AND TRADEMARKS ................................... 12
  50.            IBM .................................................... 12
  51.            Borland International .................................. 13
  52.            TesSeRact(TM) .......................................... 13
  53.            QWIK Screen Utilities .................................. 13
  54.            Data Compression ....................................... 13
  55.          OTHER SOFTWARE FROM JOHN MAJKRZAK ........................ 14
  56.          SUGGESTED READING ........................................ 14
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                     - i - 
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  72.  
  73.  
  74.        I N T R O D U C T I O N
  75.  
  76.          Pop Train (PT) is a trainable RAM resident help system able
  77.          to display specific help screens depending on the page and
  78.          field location of the cursor.  Screen capturing enables later
  79.          redisplay by PT utility software for further help system
  80.          development, briefings, etc.  Pop Train is useful in employee
  81.          training, telephone sales, general computer education or other
  82.          situations where a personalized help screen is needed.
  83.  
  84.  
  85.        O V E R V I E W
  86.  
  87.          Many computer programs are just written to be used, not
  88.          written to train someone how to use them.  Companies budget
  89.          thousands of dollars for a training department which then
  90.          struggles to teach new employees how to use the computer
  91.          program required in their job.  An often used training
  92.          technique is to stand over the shoulder of the student and
  93.          answer even the most repetitive and basic questions.  Now
  94.          there's a better way.
  95.  
  96.          Pop Train is a two part package containing PT Instructor
  97.          (PTI) and PT Utilities (PTU).  Pop Train Instructor is
  98.          available upon request during operation of another program.
  99.          Pressing a predefined key combination (hot keys) will call
  100.          Pop Train into action.
  101.  
  102.          After initial set up, a trainee can use PTI to display a
  103.          specific `help' screen when the help (hot) key is pressed.
  104.          For instance, in an order entry program the Method Of Payment
  105.          might be a one character field entitled MOP on the Order
  106.          Summary page.  The trainee needs to know what MOP means and
  107.          what different types of entries might be put there.  Pop
  108.          Train can be told how to recognize the Order Summary page and
  109.          what help screen to display when the cursor is in the MOP
  110.          field.  All the trainee needs to do is request help by
  111.          pressing the help key.  When the trainee is finished reading
  112.          the screen he or she may press any key to remove the help
  113.          screen and return to the order entry program.  Pop Train
  114.          performs these actions without disturbing any other programs
  115.          that may be running on the computer.  Also, a `disable'
  116.          feature of PTI removes options that a trainee should not
  117.          access.
  118.  
  119.          The primary feature mentioned above is especially useful in
  120.          many places where a personal computer can compliment a
  121.          mainframe application.  The PC could serve as a terminal
  122.          while keeping busy memos off the mainframe. In a computer
  123.          training course a PT help screen could be set up to answer
  124.          the questions that students often ask.
  125.  
  126.  
  127.  
  128.  
  129.                                     - 1 - 
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  138.  
  139.  
  140.          Another feature of PTI is its ability to capture a screen and
  141.          store the contents onto disk.  The Pop Train utilities
  142.          program can be used to redisplay the screen just as it
  143.          appeared before.  This feature is especially helpful when
  144.          terminals are used in the primary work center but where
  145.          training could begin on a more convenient personal computer.
  146.          Optional configuration settings enable Pop Train to perform
  147.          as a presentation system which cycles through everything
  148.          automatically.  When Pop Train is combined with DIGITONE (c),
  149.          your convention sales presentation become more convincing
  150.          than having a VCR try to do the job.  See `Other Software
  151.          From John Majkrzak' for information about Digitones voice
  152.          delivery capabilities.
  153.  
  154.          Pop Train presentation (help) screens are created using the
  155.          `edit' option included in PTU.  Presentation screen names are
  156.          assigned by Pop Train thereby making development of your help
  157.          system easy.  Help screens can be relocated onto a RAM drive
  158.          for faster display.
  159.  
  160.          Pop Train is distributed for a 30 day free trial period.  If
  161.          you like and use Pop Train then you are expected to register
  162.          your copy with the owner.  Look for registration information
  163.          elsewhere in this documentation.  Pop Train is Copyright (c)
  164.          1988 John M. Majkrzak, All Rights Reserved.
  165.  
  166.  
  167.        D I S C L A I M E R   O F   W A R R A N T Y
  168.  
  169.          John Majkrzak makes no warranty concerning the function or
  170.          fitness of Pop Train, and shall have no liability or
  171.          responsibility to any recipient with respect to liability, loss
  172.          or damage directly or indirectly arising out of the use of
  173.          Pop Train programs or associated routines, including, but not
  174.          limited to, any loss of business or other incidental or
  175.          consequential damages.
  176.  
  177.          Pop Train Copyright (c) 1988 John M. Majkrzak, All Rights
  178.          Reserved.
  179.  
  180.  
  181.        R E G I S T R A T I O N   I N F O R M A T I O N
  182.  
  183.          Pop Train is distributed for a 30 day free trial period.  The
  184.          PT software distributed for your examination is complete.
  185.          There are no features included in the registered version that
  186.          you do not see here.  Every effort was made to assure the
  187.          quality of Pop Train and your ability to judge its
  188.          effectiveness.  If you like and use Pop Train then you are
  189.          expected to register it with the owner in accordance with
  190.          U.S. Copyright Laws.  In exchange for your registration
  191.          dollars, you receive:
  192.  
  193.  
  194.  
  195.                                     - 2 - 
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  204.  
  205.  
  206.            -Uninterrupted ("Registration Requested" screen removed)
  207.             program initialization.
  208.            -The right to use the product on up to TEN computers.
  209.            -The latest `registered' version of Pop Train.
  210.            -The next major revision (upgrade) sent to you free except
  211.             for $4.00 S/H charges.
  212.            -Minor revisions (repairs) are always free, except for S/H
  213.             charges.
  214.            -Answers to your questions about the product and a pledge
  215.             of continued support.
  216.            -A share in the experience of other registrants.
  217.            -Gratitude.
  218.  
  219.          For $49.00 Pop Train is licensed for use on up to ten
  220.          computers.  All computers must be owned by the same
  221.          registrant.  Additional registrations will be required if
  222.          more than ten computers need to run Pop Train at the same
  223.          time.
  224.  
  225.          Amounts listed above are for 5.25 inch media, add $2.00 for
  226.          3.5 inch disks.  Please complete the entire application form
  227.          (PTAPPL.FRM) for registration.  Be sure to list your computer
  228.          type.
  229.  
  230.          You are free to distribute the examination edition of PT
  231.          provided no fee (other than a nominal fee for shipping and
  232.          handling) is charged to the recipient.  Do not distribute
  233.          your registered software.
  234.  
  235.  
  236.        S Y S T E M   R E Q U I R E M E N T S
  237.  
  238.          Pop Train should run on any IBM-PC, XT, AT, and PS/2 or
  239.          compatible machines with DOS 2.0 or greater.  Pop Train
  240.          Instructor requires about 57K of system memory.  Maximum
  241.          screen size is 132 by 43.
  242.  
  243.  
  244.        G E T T I N G   A C Q U A I N T E D
  245.  
  246.          If you have a hard drive use the installation batch file
  247.          (HDINSTAL) to make life easier.  If HDINSTAL is used, all Pop
  248.          Train help screens and other data created will automatically
  249.          be stored in one (C:\POPTRAIN) place.  Also, help screens
  250.          will be copied to RAM drive `D' (if available) before PTI is
  251.          loaded.  To get these results you must use the batch files
  252.          (PTIL and PTUL) for loading Pop Train.
  253.  
  254.          When PTI begins running the introduction screen may be paused
  255.          by pressing a key (quickly) prior to completion of the
  256.          introduction message.  Unregistered Pop Train users will see
  257.          a `Registration Requested' screen before the introduction
  258.          screen.
  259.  
  260.  
  261.                                     - 3 - 
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  270.  
  271.  
  272.          Get the feel for how a help system would work by trying out
  273.          the DEMO.  Help may be requested when the cursor is resting
  274.          on the first character (far left) of each data entry field.
  275.          To display the help screen press the RIGHT shift key and the
  276.          `?' key.  While in the C:\POPTRAIN directory at the DOS
  277.          prompt type `DEMO' to execute the demonstration batch file.
  278.  
  279.          The demo does not perform any real data entry since you are
  280.          actually seeing the `page' feature of the PT utilities
  281.          program.  Press the Esc (escape) key during the demo to see
  282.          what you can do.
  283.  
  284.        LOADING POP TRAIN
  285.          Assuming you are in the directory where PT resides you may
  286.          load PTI with the command `PTI HELP', where `help' represents
  287.          the name you selected for your schema.  If the schema name is
  288.          left off you are given a reminder.  Think of the schema file
  289.          as the layout or design of your help system.  Pop Train
  290.          schema files have an extension of `.H00'.  Load PT before
  291.          getting into the application you plan to use it with.
  292.  
  293.        CALLING POP TRAIN TO ACTION
  294.          First load PTI then load whatever application program you
  295.          need help with.  Press <Alt> + <Left Shift> + `T' to activate
  296.          the PTI menu.  You can pause the introduction screen to
  297.          confirm the activation sequence.  Most of your work involves
  298.          selection `T' for setting up the schema file.  The `help'
  299.          screen is displayed when the <Right Shift> + `?' key
  300.          combination is pressed.
  301.  
  302.        USING POP TRAIN WITH TRAINEES
  303.          You may not want a trainee to have access to the PT menu
  304.          screen.  The menu can be disabled.  Use the PTU `MODIFY'
  305.          command or declare a DOS environment variable called PTCONFIG
  306.          and set it equal to DISABLE.  For example, "SET PTCONFIG=
  307.          DISABLE".  The word `disable' may appear anywhere in the
  308.          configuration setting.  PTCONFIG also has other uses.  See
  309.          "Configuration Of Pop Train" elsewhere in this
  310.          documentation.
  311.  
  312.        SAVING YOUR SCHEMA FILE
  313.          When you are ready to save the schema you have been working
  314.          on you may do so by using the word SAVE in place of a schema
  315.          name just as though you were trying to load PTI again.  For
  316.          example: >PTI SAVE.
  317.  
  318.        REMOVING POP TRAIN FROM MEMORY
  319.          Remove PTI from memory with the command: `PTI R'.  You will
  320.          be prompted to save the file if changes were made.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                     - 4 - 
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  336.  
  337.  
  338.        P L A N N I N G   A   H E L P   S Y S T E M
  339.  
  340.          A planning sheet is useful in organizing your customized help
  341.          system, but before looking at one there are some things you
  342.          should know.
  343.  
  344.        SCHEMA NAME CONSIDERATIONS
  345.          The help application you build uses a naming scheme that
  346.          begins with a four character name that you assign to it.  A
  347.          recommended technique is to use the same first two characters
  348.          for all the help schemata created.  Use the third and fourth
  349.          characters to identify the specific help schema.  The advan-
  350.          tage is ease of referencing your files on disk for many of
  351.          the DOS commands you might use.  The disadvantage is small
  352.          since you will probably use a batch file to load the program
  353.          anyway.
  354.  
  355.          The name decided upon is the name given on the command line
  356.          when you load Pop Train, for example, `C>PTI HS01'.  Pop
  357.          Train will use this name as the first four characters on
  358.          each of the help screens you set up for your application.
  359.  
  360.        PAGE RECOGNITION CONSIDERATIONS
  361.          Pop Train is application/page oriented.  Each screen or item
  362.          entry page on your application must have a unique string of
  363.          characters that can be used as an identifier.  The `unique'
  364.          page name must be four characters in length and located at
  365.          the same spot on each page.  Most applications will meet this
  366.          requirement even though it was not planned.  Look over each
  367.          page of your application carefully to find a location that
  368.          will work.  Generally, you should start your search at the
  369.          upper left corner of the screen or consider screen titles
  370.          like; item entry (ITEM), customer entry (CUST), or order
  371.          summary (ORDE), provided each page has them in the same
  372.          location.
  373.  
  374.          The rules you should follow about the page name are simple.
  375.          At least one of the four characters must be unique.  The
  376.          other three characters could all be the same.  Even graphics
  377.          characters are allowed because any character that Pop Train
  378.          does not like will be remembered as the negation (-) symbol.
  379.  
  380.        FIELD/CURSOR CONSIDERATIONS
  381.          Each help screen to be displayed will need to be assigned to
  382.          it's own specific cursor location.  Usually the location
  383.          should be the same place the cursor jumps to when it enters
  384.          the field.
  385.  
  386.          After deciding which fields are in need of help screens, you
  387.          should plan on assigning their locations to Pop Train in the
  388.          same order that data is normally entered.  There are two main
  389.          benefits in doing so; file name extensions will correspond to
  390.          the field number, and second, field movement during the PAGE
  391.  
  392.  
  393.                                     - 5 - 
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  402.  
  403.  
  404.          feature of PT utilities will match.
  405.  
  406.        MAKE A PLANNING SHEET
  407.          See the PTPLAN.FRM file for more information about planning
  408.          your help system.
  409.  
  410.  
  411.        U T I L I T I E S
  412.  
  413.          The PT Utilities program is where the most expansion of
  414.          capabilities is likely to occur as registered users send in
  415.          their suggestions.  When not configured for `trainee' use,
  416.          a menu is displayed if no command line is given.  Some
  417.          features need to activated through the command line, for
  418.          example: >PTU MODIFY
  419.  
  420.        RAM
  421.          A RAM or vDisk is highly recommended for use with Pop Train.
  422.          The RAM option offered by the PTU program is only a
  423.          convenient alternative to setting up a batch file to do the
  424.          same job.  Using DOS commands is actually faster (in most
  425.          cases) than using the RAM option.  Only help files will be
  426.          transferred.  For rapid display of page screens during use of
  427.          the PTU PAGE feature you could use the DOS command:
  428.            `COPY HELP*.SCR D:'.
  429.  
  430.        PAGE
  431.          The PAGE feature will assist in familiarizing students or new
  432.          employees with a computer application without actually having
  433.          to run the program they are being trained on.
  434.  
  435.          Another reason for using PAGE instead of your regular
  436.          application is the ability to teach PT to position the cursor
  437.          in places that it may not normally go.  The potential use is
  438.          to highlight and provide additional explanation about screen
  439.          items that are display only, for example, the `order total'.
  440.  
  441.          To use the page feature you must first capture the PAGE using
  442.          Pop Train Instructor.  If the system is configured for a
  443.          trainee then the PAGE utility starts automatically since it
  444.          is the only one available to a trainee.
  445.  
  446.        EDIT
  447.          The file editing facilities of PTU must be used to edit all
  448.          help screens.  To edit the help files identified within a PT
  449.          help schema, load PTI with the schema, next load PTU without
  450.          any command line and select the EDIT option from the main
  451.          menu.  While using the editor you may press the escape key to
  452.          get help.  The editor is easy to use.  Other instructions are
  453.          given by the program.
  454.  
  455.          Avoid confusion, do not have help screens on RAM disk while
  456.          editing them.  Only screens on the default (primary) path are
  457.  
  458.  
  459.                                     - 6 - 
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  468.  
  469.  
  470.          edited.
  471.  
  472.          Editor access is also available from the PAGE routine, but
  473.          not if PT is being used with a trainee.  Accessing the editor
  474.          from the page routine can be much easier.
  475.  
  476.        MODIFY
  477.          This option is activated from the command line, for example:
  478.          >PTU MODIFY.  Default colors for the Pop Train menus and your
  479.          help screens can be set using MODIFY.  A wider selection of
  480.          alternate hot keys is offered through `modify' than the
  481.          PTCONFIG (see Configuration Of Pop Train, Hot / Help Keys)
  482.          variable allows.  A modified copy of Pop Train can be LOCKED
  483.          for `trainee' use.  When Pop Train is locked, the DISABLE
  484.          command (see Using Pop Train With Trainees) need not be
  485.          given.  CAUTION, do not let the MODIFY feature write over
  486.          your existing copy of Pop Train if it is the only one you
  487.          have.
  488.  
  489.  
  490.        M U L T I P L E   A P P L I C A T I O N S
  491.  
  492.          Most training sessions or jobs only involve one task or
  493.          application at a time.  Likewise, PT is best when used to
  494.          cover one application.  Should you need more applications,
  495.          for example, both `inbound' and `outbound' sales, then just do
  496.          everything twice.  Use a different name for each application
  497.          and set up a batch file to load Pop Train as needed prior to
  498.          loading whatever program you need.
  499.  
  500.          If PT is used in the daily work center and people need help
  501.          screens across different applications then it won't hurt to
  502.          give it a try.  Remember PT is limited to nine pages and all
  503.          pages must have the identifier at the same screen location.
  504.  
  505.  
  506.        R A M   D R I V E   U S A G E
  507.  
  508.          Pop Train will check for a RAM (vDisk) drive `D' when it gets
  509.          loaded.  You may specify the path (or any other drive) to be
  510.          checked.  Use the DOS `SET' command to include two path names
  511.          in PTPATHS as explained in the `Directories And Files'
  512.          section.
  513.  
  514.          The first path is the PT default data path.  Separate the
  515.          first and second paths with a semicolon (like the DOS `PATH'
  516.          command). Leave no spaces anywhere in PTPATHS, for example,
  517.          `SET PTPATHS=C:\POPTRAIN;D:\POPTRAIN'.  Only the default
  518.          (first) path specified is used by PT to store data.
  519.  
  520.          It is OK to specify the second path even if that drive does
  521.          not exist.  Only the RAM utility of PTUTIL will issue an
  522.          error message if the second path is not found.  All others
  523.  
  524.  
  525.                                     - 7 - 
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  534.  
  535.  
  536.          simply revert to the first (default) path.  No RAM drive
  537.          specification is needed if your screens are on the root
  538.          directory of drive `D' because `D:\' is used as a default.
  539.  
  540.          For more about DOS paths, see the `PATH' command in your
  541.          systems operations manual.
  542.  
  543.  
  544.        D I R E C T O R I E S / F I L E S   A N D   P O P   T R A I N
  545.  
  546.          Pop Train will create one file on your disk for each help
  547.          schema you create.  Usually only one schema will be needed
  548.          for each application.  The directory Pop Train leaves its
  549.          files in is up to you.  Prior to loading Pop Train you can
  550.          use the DOS `SET' command to create a memo (PTPATHS) for PT
  551.          to read.  The memo will tell PT where its file directory is
  552.          located.  For example, `SET PTPATHS=C:\POPTRAIN', tells PT to
  553.          look in the subdirectory \POPTRAIN on drive `C' for all its
  554.          files.  If the PTPATHS memo is not found then PT will use the
  555.          directory you were in when PT was loaded and you should take
  556.          steps to always be in the same subdirectory when loading Pop
  557.          Train.
  558.  
  559.          If you have been working on a help schema and discover the
  560.          page identifier was not located in the proper position, you
  561.          will need to start over.  Pop Train automatically initializes
  562.          new files.  Therefore, to start over again you should delete
  563.          the schema file from your disk drive after removing PT from
  564.          the computer memory.  For example, `DEL HELP.H00', will
  565.          enable you to start fresh.
  566.  
  567.  
  568.        F L O P P Y   D I S K   O N L Y   U S E R S
  569.  
  570.          Pop Train works fine for floppy disk users, although the
  571.          experience would be more pleasant if used with RAM drive
  572.          software.  Details about installing RAM drive software is
  573.          beyond the scope of this documentation but RAM drive usage
  574.          is covered in its own section.
  575.  
  576.          To work on a floppy based system you will need enough room
  577.          for Pop Train and whatever else needs to share the disk.  All
  578.          you can do is try.  If you have two drives you can use
  579.          FDINSTAL.BAT to install Pop Train onto the disk in drive B.
  580.          If your managing with one drive then follow these
  581.          instructions to put Pop Train onto your data disk.
  582.  
  583.                 Step 1: A>B:
  584.                 Step 2: B>CD\
  585.                 Step 3: B>MD POPTRAIN
  586.                 Step 4: B>CD POPTRAIN
  587.                 Step 5: B>COPY A:PT*.* B:\POPTRAIN\*.*
  588.  
  589.  
  590.  
  591.                                     - 8 - 
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  600.  
  601.  
  602.          Comments for each step above.
  603.                 Note 1: Change to drive B: You will be asked to
  604.                         install disk for drive `B', just be sure the
  605.                         disk you want PT to be on gets put into the
  606.                         drive now.
  607.                      2: Let's be sure we are in the root directory.
  608.                      3: Make directory POPTRAIN.
  609.                      4: Change to directory POPTRAIN.
  610.                      5: Copy Pop Train files from the disk where you
  611.                         had it to the current directory of this disk.
  612.                         Follow the instructions that the DOS system
  613.                         gives you.
  614.  
  615.          Notice a copy statement (similar to step 5:) can be used to
  616.          transfer the demonstration files to another disk.  Use the DOS
  617.          `delete' command to get rid of the files you won't be using
  618.          on a regular basis.
  619.  
  620.          When ready to run your application you should first load Pop
  621.          Train with the PT (and other) data disk in the drive.  Next
  622.          you may need to remove the data disk to install the program
  623.          disk and load the application before reinstalling the data
  624.          disk.
  625.  
  626.  
  627.        C O N F I G U R A T I O N   O F   P O P   T R A I N
  628.  
  629.          Several options are available to customize the behavior of
  630.          PT.  Changes are made using the DOS `SET' command to create a
  631.          variable called `PTCONFIG', for example `SET PTCONFIG= pd/02
  632.          rd/08 cr disable'.  Do not leave a space between the word
  633.          `PTCONFIG' and the equal sign.  Spaces are ok after the equal
  634.          sign.  The assignment must be done prior to loading Pop
  635.          Train.  Upper or lower case letters and the order of your
  636.          selections are not important.
  637.  
  638.          A mistake may go unnoticed with no error message issued.  If
  639.          you don't get the results you're expecting check for mistakes
  640.          like transposed letters or such.
  641.  
  642.          Once you decide what you want, place your configuration
  643.          settings on a line in the batch file you use to load Pop
  644.          Train.  Should you need help making batch files try one of
  645.          the books mentioned under `Suggested Reading.'
  646.  
  647.        AUTOMATIC POP-UP
  648.          During operation of the PTU Page feature, automatic pop-up of
  649.          a presentation screen is possible.  A time delay of 0 to 99
  650.          seconds can be set.  The pop-up will only occur after the
  651.          cursor has been resting on a valid pop-up location for the
  652.          specified period of time.
  653.  
  654.  
  655.  
  656.  
  657.                                     - 9 - 
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  666.  
  667.  
  668.          Use `PD/nn' in the PTCONFIG variable to indicate you want
  669.          automatic pop-up to occure.  The nn designates the time
  670.          delay.  Both places must be used.  Some examples:
  671.  
  672.            `pd/00' results in immediate Pop-Up.
  673.            `pd/02' results in 2 second wait then Pop-Up.
  674.            `pd/2'  WRONG
  675.            `pd\02  WRONG
  676.  
  677.          Due to excessive processing time, the automatic pop-up
  678.          feature is only available during operation of PTU PAGE.
  679.  
  680.        AUTOMATIC REMOVAL OF PRESENTATION SCREEN
  681.          Prior to loading PTI you may add a configuration setting
  682.          which will result in automatic removal of a presentation
  683.          (help) screen.  The option is similar in use to the automatic
  684.          pop-up setting, although automatic removal is not restricted
  685.          for use only during PTU PAGE.  Some examples:
  686.  
  687.            `rd/08' results in removal after an eight second display.
  688.            `rd/15' results in removal after fifteen second display.
  689.            `rd/122' WRONG (12 second delay with a stray 2 remaining)
  690.            `rd\15'  WRONG
  691.  
  692.        KEYBOARD RETURNS; K/0, K/1, K/2
  693.          K/0
  694.            This is the PTI default setting.  The keyboard buffer is
  695.            cleared before returning control to your primary
  696.            application.
  697.          K/1
  698.            There may be situations when you always want a carriage
  699.            return (ENTER key) to be processed every time a
  700.            presentation screen is removed.  Such a situation occurs
  701.            when you want to use PTI and PTU to cycle through all your
  702.            presentation screens automatically.
  703.  
  704.            To get the carriage return sent by PTI just include `K/1'
  705.            in the configuration variable, for example: `SET PTCONFIG=
  706.            RD/08 K/1' will remove the screen after eight seconds and
  707.            send a carriage return through to your other application.
  708.  
  709.            NOTE: If the K/1 option is seen by PTU, then each time you
  710.            are on the last field of a page, PTU will proceed to the
  711.            next page in the sequence.  Therefore, should you not want
  712.            the page to flip automatically, remove the K/1 from the
  713.            PTCONFIG variable before loading PTU.
  714.          K/2
  715.            To cause PTI to allow the key press to pass through to your
  716.            application place `K/2' in the configuration setting.  This
  717.            might be helpful if you are using a PTI help screen to
  718.            display a list of options.
  719.  
  720.  
  721.  
  722.  
  723.                                     - 10 - 
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  732.  
  733.  
  734.        DIGITAL VOICE PLAYBACK
  735.          For DIGITONE (c) users only.  When using Digitone and PT
  736.          together there is one configuration setting for Digitone (DT)
  737.          that must be given to Pop Train.  When everything is ready
  738.          (as per the Digitone instructions) PT will pass Digitone the
  739.          voice file name to playback in association with the
  740.          presentation screen on display.  Pop Train must also tell DT
  741.          if it is to playback the voice file immediately or prompt the
  742.          user first.  The configuration setting you need to give PT
  743.          will cause it to tell Digitone that playback should be
  744.          immediate.  Digitone playback defaults to prompting the user.
  745.  
  746.          Use the PTCONFIG variable to tell PT you want Digitone to
  747.          playback without prompting the user first.  Simply include
  748.          the identifier `dvp' along with any other configuration
  749.          information you give Pop Train.
  750.  
  751.          For example, `SET PTCONFIG= pd/02 rd/08 k/1 disable dvp'.
  752.  
  753.        HOT/HELP KEYS
  754.          Pop Train programs need no attention to these details unless
  755.          you become aware of problems due to interference with similar
  756.          settings in other programs.  Alternate selections are listed
  757.          below.  See also, `Using Pop Train With Trainees' elsewhere
  758.          in this documentation.
  759.  
  760.          -Pop Train Instructor menu hot key.
  761.            Default setting is `T'.
  762.            Alternate choices are `Z', `X', `C'.
  763.            The <Alt> + <LShift> keys may not be changed.  Therefore,
  764.            after changing the keyboard assignment the new hot key
  765.            combination becomes <ALT> + <LSHIFT> + <Your choice>.
  766.  
  767.          -Pop Train Instructor Help Window hot key.
  768.            Default setting is `?'.
  769.            Alternate choices are `M', `,'(comma), `.'(period).
  770.            The <RShift> key may not be changed.  After changing the
  771.            keyboard assignment the new hot key combination becomes
  772.            <RShift> + <Your choice>
  773.  
  774.          Example: `SET PTCONFIG=X' changed PTI menu hot key to X.
  775.          Example: `SET PTCONFIG=Z.' changed PTI menu hot key to `Z'
  776.                                    and help hot key to `.' (period).
  777.  
  778.          An incorrect attempt to reassign a hot key will leave the
  779.          default setting intact with no error message issued.  If a
  780.          conflict is detected you will be warned.
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                     - 11 - 
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  798.  
  799.  
  800.  
  801.        R E V I S I O N   H I S T O R Y   A N D   N O T E S
  802.  
  803.          The only changes listed here are the ones of consequence to
  804.          existing users.
  805.  
  806.            Version 1.0 dated 11/13/88.
  807.              - First release of original Pop Train.
  808.            Version 1.1 dated 01/11/89.
  809.              - Schema files need to be upgraded using PTUPGRD utility
  810.                before they will operate with v1.1 of Pop Train.
  811.                PTUPGRD is mailed FREE to existing registrants.  It
  812.                is possible to simply reenter all the schema inform-
  813.                ation.
  814.              - PTI `must' be present in memory for any feature of PTU
  815.                to operate.
  816.              - The MODIFY command is added to PTU.
  817.              - Compatibility with Digitone Version 1.0 is added.
  818.            Version 1.1 (release 2) dated 01/19/89.
  819.              - No software changes.
  820.              - Archive technique is changed.  Self extracting form of
  821.                PT is no longer distributed in an effort to open up my
  822.                market more.  BBS operators scorn the additional disk
  823.                space required by a self extracting software package.
  824.              - Changes to installation batch files.
  825.            Version 1.2 dated 05/05/89.
  826.              - Configuration options `K/n', `PD/nn', `RD/nn' and `DV/a'
  827.                are added.
  828.              - Digitone promotional supplement is added, see
  829.                DIGIDOC.PRO in this archive.
  830.              - System crash after reloading PTI for a file exchange is
  831.                resolved.  Problem report dated 4/3/89.
  832.            Version 1.2 (release 2) dated 05/12/89.
  833.              - No software changes
  834.              - Self extraction is back.  New archival software gets
  835.                the go ahead from SYSOPS if used to produce a self
  836.                extracting archive because it combines some much needed
  837.                features with low low overhead.
  838.  
  839.  
  840.        P R O B L E M   R E P O R T I N G
  841.  
  842.          Should you discover something wrong with Pop Train, even if
  843.          you are not yet registered, please report the problem.
  844.          Include information about your computer (brand, micro-
  845.          processor and BIOS version), your DOS version, video card and
  846.          other software you are using with Pop Train.  Send to:
  847.  
  848.            John Majkrzak                     Ph#(612)636-9761
  849.            1880 Todd Dr.                     CIS# 76617,264
  850.            Arden Hills, MN  55112
  851.  
  852.  
  853.  
  854.  
  855.                                     - 12 - 
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  864.  
  865.  
  866.        C R E D I T S   A N D   T R A D E M A R K S
  867.  
  868.        IBM
  869.          IBM, IBM Personal Computer, IBM Personal Computer XT, IBM
  870.          Personal Computer AT and PS/2 are registered trademarks of
  871.          International Business Machines Corporation.
  872.  
  873.        Borland International
  874.          Pop Train was created using Turbo Pascal, Copyright (C)
  875.          Borland International 1987, 1988.
  876.  
  877.        TesSeRact
  878.          This product uses the TesSeRact(TM) ram-resident library and
  879.          supports the TesSeRact standard for  ram-resident program
  880.          communication.  For information about TesSeRact contact the
  881.          TesSeRact Development Team at:
  882.  
  883.               TesSeRact Development Team
  884.               c/o Chip Rabinowitz
  885.               2084 Woodlawn Avenue
  886.               Glenside, PA 19038
  887.               1-215-884-3373
  888.  
  889.               Compuserve: 70731,20
  890.               MCIMAIL:  315-5415
  891.  
  892.          The MCIMAIL Account has been provided to the TesSeRact
  893.          Development Team by Borland International, Inc.  The
  894.          TesSeRact Development Team is in no way associated with
  895.          Borland International, Inc.  TesSeRact is a trademark of the
  896.          TesSeRact Development Team.
  897.  
  898.        QWIK Screen Utilities
  899.          This program uses copyrighted QWIK routines from Eagle
  900.          Performance Software which are included by permission.  For
  901.          more information about QWIK direct video screen access
  902.          routines please contact:
  903.  
  904.                Eagle Performance Software
  905.                TP Products
  906.                Attn: James H. LeMay
  907.                P.O. Box 122237
  908.                Ft. Worth, TX 76121
  909.  
  910.          As a note, the PT introduction routine displays 64 boxes on
  911.          screen.  The speed was throttled down to a rate of 18 per
  912.          second.
  913.  
  914.        Data Compression
  915.          The archival program used to condense Pop Train is not
  916.          software from John Majkrzak.  A separate file having the
  917.          extension "REC" gives recognition to the author.
  918.  
  919.  
  920.  
  921.                                     - 13 - 
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.             POP TRAIN  Copyright (c) 1988, 1989  JOHN M. MAJKRZAK. 
  930.  
  931.  
  932.        O T H E R   S O F T W A R E  F R O M   J O H N  M A J K R Z A K
  933.  
  934.          Digitone: Imagine a prerecorded message delivered to your
  935.          listener automatically.  Digitone (c) can do it.  With both
  936.          Digitone and Pop Train, you can make a complete audio/video
  937.          presentation and more!  See DIGIDOC.PRO included with Pop
  938.          Train.
  939.  
  940.          Public domain include files for Turbo Pascal programmers
  941.          located in library 2 of Borland languages forum (BPROGA) on
  942.          Compuserve include: SDEFSn.ARC, VT52.PAS, CURDLn.ARC.  Lower
  943.          case `n' designates the version number.
  944.  
  945.          Selected routines used in PT are available to Turbo Pascal
  946.          and Assembler programmers.  Mention your needs when
  947.          registering.
  948.  
  949.  
  950.        S U G G E S T E D   R E A D I N G
  951.  
  952.          Hoffman, P., Nicoloff, T. "The Osborne/McGraw-Hill MS-DOS
  953.            USERS GUIDE". Berkeley, CA: Osborne/McGraw-Hill, 1984.
  954.  
  955.          Wolverton, V., "Supercharging MS DOS: The Microsoft Guide to
  956.            High Performance Computing for the Experienced PC User".
  957.            Redmond, WA: Microsoft Press, 1986.
  958.  
  959.          Norton, P., "Inside the IBM PC". New York, NY: Prentice Hall
  960.            Press, 1986.
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                     - 14 - 
  988.  
  989.  
  990.  
  991.